home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audiofile / AFgetaeschanneldata.z / AFgetaeschanneldata
Encoding:
Text File  |  1998-10-20  |  5.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa((((3333ddddmmmm))))                              aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afGetAESChannelData, afSetAESChannelData - get/set AES channel status
  10.      information in an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure for an audio track
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt ttttrrrraaaacccckkkk,,,,
  16.                               uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr bbbbuuuuffff[[[[22224444]]]]))))
  17.  
  18.      vvvvooooiiiidddd aaaaffffSSSSeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt ttttrrrraaaacccckkkk,,,,
  19.                               uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr bbbbuuuuffff[[[[22224444]]]]))))
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  22.      _f_i_l_e    expects an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure, previously created by a call
  23.              to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  24.  
  25.      _t_r_a_c_k   expects an integer which identifies the audio track in the file.
  26.              Since all currently supported file formats allow at most one
  27.              audio track per file, the constant value AAAAFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTRRRRAAAACCCCKKKK should
  28.              always be used for this argument for now.
  29.  
  30.      _b_u_f     is a data buffer used to pass the 24 bytes of AES channel status
  31.              data to aaaaffffSSSSeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa(((()))), or to obtain the 24 bytes of AES
  32.              channel status data from aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa(((()))).
  33.  
  34. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  35.      aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa(((()))) returns 0 if there is no AES channel status
  36.      information associated with the given track, 1 if there is AES data, and
  37.      -1 in the event of an error.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      aaaaffffSSSSeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa(((()))) writes the specified AES channel status data bytes
  41.      into the appropriate header location of ffffiiiilllleeee.  If no header space has
  42.      been reserved in the header by aaaaffffIIIInnnniiiittttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa(3dm), the routine
  43.      will ignore the data and return.
  44.  
  45.      aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa(((()))) copies the channel status data for _t_r_a_c_k into _b_u_f.
  46.      If no AES channel status data is found, it returns 0.
  47.  
  48. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  49.      These functions will always manipulate data that is to be interpreted as
  50.      AES channel status data, but there is never any guarantee that such data
  51.      will be present in a given input file or not, or will be allowed in a
  52.      given output file or not (unless the file format of the file being read
  53.      or written requires that AES data is always present).  Even in the
  54.      formats AIFF and AIFF-C, the presence of AES channel status data is
  55.      optional.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa((((3333ddddmmmm))))                              aaaaffffGGGGeeeettttAAAAEEEESSSSCCCChhhhaaaannnnnnnneeeellllDDDDaaaattttaaaa((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm), aaaaffffRRRReeeeaaaaddddFFFFrrrraaaammmmeeeessss(3dm), aaaaffffIIIInnnniiiittttCCCChhhhaaaannnnnnnneeeellllssss(3dm), aaaaiiiiffffcccc(4)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.